home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / ip / ka9q / pxx111.arc / TCP.DOC < prev    next >
Text File  |  1988-02-16  |  8KB  |  205 lines
  1.  
  2. The PXX Gateway version 1.10
  3.  
  4.  
  5. Summary:
  6.  
  7.    The PXX Gateway permits WA7MBL 2xx,3xx,4xx BBS users to pass messages
  8. to and from SMTP on KA9Q's TCP/IP "NET" versions 871225.6 or higher.  I
  9. assume that you are using DDOS or Deskview, with the BBS in one partition
  10. and Net running in the other.  The gateway exploits the X type forwarding
  11. capabilities to selectively "export" messages from the WA7MBL bbs to
  12. \SPOOL\MQUEUE directory for subsequent periodic processing automatically
  13. by SMTP running on NET.  Messages destined for routing thru the BBS are
  14. "extracted" by a new feature in NET (871225.6 or later).  A AUTOEXEC.NET
  15. command SMTP MODE QUEUE (as contrasted by SMTP MODE ROUTE) permits messages
  16. which are NOT local users to be placed in \SPOOL\RQUEUE directory in much
  17. the same way as NET handles \SPOOL\MQUEUE "notesfiles".  Local users are
  18. any user that is found in the HOSTS.NET file.  If you want a message routed
  19. to the BBS from SMTP you may address the message: N5FFN%WA5MPQ@WA3PXX
  20. The gateway will change the address to N5FFN@WA5MPQ after it arrives at
  21. WA3PXX BBS.  Another feature of the gateway is to distribute bulletins
  22. (as known by WA7MBL BBS) via SMTP on TCP/IP.  In this way the local bulletins
  23. passed around the local BBS's are automagically routed directly to User
  24. on his PC!  Bulletins and private mail may be originated from TCPIP/BM
  25. and automatically routed to the BBS.
  26.  
  27.  
  28.  
  29.  
  30. Organization of the PXX gateway version 10.1
  31.  
  32. Packet Bulletin Board           \/           KA9Q TCP/IP Environment
  33.  
  34.       (FWD.BBS)             PXX Gateway     SMTP directory
  35. --------------------\                                       * sample files
  36. W                   \
  37.       X TCPIP       \
  38. A     @TCPIP.TXT    \ ====> [ TCP.COM  ] ===> \SPOOL\MQUEUE  { smtp input }
  39.       wb6rqn        \
  40. 7     ka4tmb        \                                        *4234.TXT
  41.       ...           \                                        *4234.WRK
  42. M     ________      \
  43.       T C:\$$WRK.$$ \ <==== [ TCPX.COM ] <=== \SPOOL\RQUEUE  { smtp output}
  44. B     00-23         \
  45.       ________      \                               ^        *2345.TXT
  46. L                   \                               |        *2345.WRK
  47.       T BULL        \                               |
  48. B     @TCPIP.TXT    \ <==== [ TCP.COM FORWARD.LST ] +
  49. B     $ARRL         \                    ^
  50. S     $MBLBBS       \                    |
  51.       ...           \                    +---- File with Bulletin Call List
  52. --------------------\
  53.  
  54. The gateway is composed of two programs and two files:
  55.  
  56. TCPX.COM    Program to "extract" messages from TCP/IP to WA7MBL BBS.
  57. TCP.COM     Program to "import"  messages from WA7MBL BBS to TCP/IP.
  58. FORWARD.LST File with list of stations to forward bulletins to.
  59. PXX.CNF     Configuration file for TCPX.COM and TCP.COM programs.
  60.  
  61. The following files are created by the gateway (all in the directory
  62. that the WA7MBL PBBS runs in).
  63.  
  64. TCPIP.TXT   This file is created out of the FWD.BBS file for local users
  65.             and for Bulletin forwarding.
  66.  
  67. Format of the PXX Gateway FORWARD.LST file:
  68.  
  69. <host>,<Bulletin "To: " name>
  70.  
  71. # is comment character
  72.  
  73. Example:
  74.    To forward to 3 local TCP/IP users via PXX Gateway (wb6rqn,ka4tmb,w3fws).
  75.  
  76. #
  77. #  sample FORWARD.LST file for forwarding Bulletins via PXX Gateway
  78. #
  79. wb6rqn,bulletin
  80. ka4tmb,bulletin
  81. w3fws,bulletin
  82.  
  83.  
  84.    "bulletin" could be any valid SMTP string
  85.  
  86.  
  87.  
  88.  
  89. The following modifications must be made to the following WA7MBL BBS
  90. files:
  91.  
  92. FWD.BBS     add entries for T "import" , X "export" and two D ("DOS")
  93.             entried to call batch (.BAT) file to execute TCP and TCPX
  94.             programs.
  95.  
  96. $E          $E entries for name on X "export" on FWD.BBS file.
  97.             (This a WA7MBL BBS command..listed only as a reminder!)
  98.  
  99.  
  100.  
  101. The following modifications must be made to AUTOEXEC.NET
  102.  
  103. SMTP MODE QUEUE  -To "export" unknown messages to PXX gateway.
  104.  
  105. *            Everyone in you LAN (local users) should specify you as there
  106.              default gateway. In this way if your users specify an unknown
  107.              host (the @HOST) the mail will be sent your way by default.
  108.                       SMTP DEFAULT WA3PXX
  109.  
  110. SMTP TIMER 300   -To specify to SMTP every 300 seconds to check \SPOOL\MQUEUE
  111.                   for new TCP/IP messages.
  112.  
  113.  
  114. The following files in the BBS default directory must be configurated.
  115.  
  116. PXX.CNF           This file contains the two path names for SMTP files.
  117.  
  118.                   First record contains pathname of \SPOOL\MQUEUE\
  119.                   Second record contains pathname of \SPOOL\RQUEUE\
  120.  
  121. FORWARD.LST       List of users, and bulletin addresses.  # is comment char.
  122.  
  123.  
  124.  
  125. Instructions for Installation of the PXX Gateway:
  126.  
  127. (1)  Create FORWARD.LST with names of each user as defined in HOSTS.NET file.
  128.      Sample FORWARD.LST is included as an example.
  129.  
  130. (2)  Create PXX.CNF with two standard text records.  The first is the
  131.      path name of the SMTP \SPOOL\MQUEUE\ directory:
  132.      The second record is the name of the "export" directory \SPOOL\MQUEUE\
  133.      Sample PXX.CNF file is included for an example.
  134.  
  135. (3)  Copy TCP.COM into WA7MBL BBS default directory.
  136. (4)  Copy TCPX.COM  "   "      "   "       ".
  137.  
  138. (5)  Modify sample FWD.BBS to include T and X entries to your FWD.BBS
  139.  
  140. (6)  Create a batch file TCPX110.BAT in the BBS default directory
  141.      like sample TCPX110.BAT.
  142.  
  143. (7)  Create a batch file TCP110.BAT in the BBS default directory
  144.      like sample TCP110.BAT.
  145.  
  146. (8)  Create a batch file TCPB110.BAT in the BBS default directory
  147.      like sample TCPB110.BAT.
  148.  
  149. Installation checklist:
  150.  
  151. (1) PBBS FWD.BBS file contains X entry pointing to TCPIP.TXT with call
  152.     signs of all local automatic distribution.
  153.  
  154. (2) A D entry in FWD.BBS after (1) above calling TCP110.BAT.  This file
  155.     contains a short batch job to kick-off TCP.COM.
  156.  
  157. (3) A X entry in FWD.BBS after (2) above, exporting bulletins with the
  158.     $BULL format to TCPIP.TXT.
  159.  
  160. (4) A D entry in FWD.BBS after (3) above, to TCPB110.BAT. This file contains
  161.     a short batch job to execute TCP.COM with a FORWARD.LST file as the
  162.     first parameter.
  163.  
  164. (5) A D entry in FWD.BBS after (4) above, to TCPX110.BAT.  TCPX110.BAT
  165.     is a short batch job to 'import' mail from SMTP to WA7MBL bbs.
  166.  
  167. (6) A T entry in FWD.BBS after (5) above, to $$WRK.$$$.  This 'imports'
  168.     messages into WA7MBL BBS via the "T" (Text-to-mail) command in FWD.BBS.
  169.  
  170. (7) PXX.CNF has two entries first pointing to \SPOOL\MQUEUE\ ,
  171.    \SPOOL\RQUEUE  of your NET.
  172.  
  173. (8) Make sure you have a \SPOOL\MQUEUE directory defined.  Create
  174.     \SPOOL\RQUEUE directory.
  175.  
  176. (9) FORWARD.LST has a complete list of bulletin users. The first field
  177.     in the record is HOST call sign, followed by a comma. The next field
  178.     is the "To:" for bulletins.  Normally its "Bulletin".
  179.  
  180.  
  181.  
  182. Testing installation of Gateway:
  183.  
  184. Enter a message on the WA7MBL to one of the users defined in FWD.BBS
  185. for local users.
  186.  
  187. Have a user add you as there default mail gateway.
  188. Have the user send a message to any user on a remote unconnected BBS.
  189. This should cause a message to appear at your station as: AUSER@REMOTE
  190. and the EXPORT gateway TCPX.COM should extract it from \SPOOL\RQUEUE
  191. delete it ...and create a text-to-mail input into WA7MBL BBS.
  192.  
  193. Issue a command X to the WA7MBL BBS to start forwarding. You should see
  194. the user message sent to the BBS.  You should see the message you entered
  195. into the BBS as a couple of #.WRK, #.TXT in the \SPOOL\MQUEUE directory
  196. (as defined in PXX.CNF).
  197.  
  198.  
  199. Good luck and feel free to send me questions, comments and problems,
  200. or bugs to:
  201.  
  202. WA3PXX@WA3PXX PBBS (HF gateway W3IWI via SKIPnet).
  203.  
  204.  
  205.